home *** CD-ROM | disk | FTP | other *** search
/ Mac Expert 1995 Winter / Mac Expert - Winter 95.iso / Les fichiers / Utilitaires divers / Images / RTrace 1.0 ƒ / RTrace-docs / README < prev    next >
Encoding:
Text File  |  1992-11-10  |  3.8 KB  |  108 lines  |  [TEXT/ttxt]
  1. Note to Macintosh users:
  2.  
  3. If you are going to install the program on another system, you should get
  4. the most recent distribution (rtrace-8.0) from INESCN..    
  5.  
  6. If you encounter Macintosh specific bugs, please contact: Reid Judd at
  7. ILLUMINATI@AppleLink.Apple.Com immediately and help me solve them.  General 
  8. rtrace bugs, suggestions, and complements for such a great program should be 
  9. refered to Antonio Costa.
  10.  
  11. The RTrace Textures directory contains SFF files which each render a single
  12. sphere with a different texture on each one.  To see it render the textures,
  13. select from the Options dialog: "Texture: Inside Objects Field" otherwise, you
  14. will just see a blank sphere.  Note that the image texture mapping files:
  15. image.sff and image1.sff can only open the image map once in a session and
  16. it must be in PPM format.  The next version will allow multiple images and
  17. support for PICT format images.
  18.  
  19. -- reid judd 
  20.      ILLUMINATI@AppleLink.Apple.Com
  21.  
  22. ((the rest of this document is the original message of the README))
  23.  
  24. ###############################################################
  25.                `rtrace' RAYTRACER
  26.              written by Antonio Costa
  27.                 a_costa@inescn.pt
  28.               a_costa@inescn.rccn.pt
  29.                acc@asterix.inescn.pt
  30. ###############################################################
  31.  
  32. This represents the 7th formal release of the `rtrace' Raytracer.
  33. It was written to help me understand how raytracing works, to
  34. generate cute images, and generally because I like to program. 
  35. Feel free to use it for any purpose, I am releasing it into the 
  36. public domain.
  37.  
  38. The input format to this ray tracer is called "SFF" or Simple File
  39. Format, after using "NFF" or Neutral File Format, which was invented
  40. by Eric Haines' for his Standard Procedural Database.
  41. The SPD was designed to allow programmers to test their
  42. raytracers on databases of varying sizes.  While not the end-all to
  43. object file formats, it has served me well.
  44.  
  45. If anyone uses or wants to use NFF, I can send a NFF to SFF
  46. converter.
  47.  
  48. SFF supports the following concepts and primitives:
  49.     point lights
  50.     directional lights
  51.     spot lights with fall-off
  52.     extended lights
  53.     2 ways of defining surfaces
  54.     spheres
  55.     axis-aligned parallelipipeds
  56.     cylinders
  57.     cones
  58.     bicubic patches
  59.     polygons
  60.     polygonal patches (normals are interpolated from corner points)
  61.     3D text with high quality
  62.     CSG operations
  63.     4x4 matrix transformations
  64.     textures
  65.     depth of field
  66.     diffuse distribution
  67.     stereoscopic pair creation
  68.  
  69. The `rtrace' raytracer supports all of these primitives, with the minor
  70. limitation that polygonal patches must be triangles (have only three
  71. vertices).
  72.  
  73. Procedural textures (with 4x4 matrix transformations) are also supported:
  74.     checkerboard
  75.     color blotches
  76.     marble
  77.     bump map
  78.     fbm
  79.     fbm bump map
  80.     wood
  81.     gloss
  82.     image mapping
  83.     waves
  84.     (and many others...)
  85.  
  86. The output from the raytracer is very simple, and not directly tied to
  87. any specific device.   It consists of a single line, with format in 
  88. C style of "%c%c%c%c", which gives the resolution of the image
  89. (Width LSByte, Width MSByte, Height LSByte, Height MSByte).
  90. It is then followed by Width*Height sets of (red green blue) bytes.
  91.  
  92. I have lots of filters source code for displaying the ".pic" files,
  93. as well as interesting objects that I run accross.
  94. Filters already exist to display images on Suns, to convert to PostScript,
  95. as well as X11 bitmaps for xwud.
  96.  
  97. I advise you to get a package called the "Fuzzy Bitmap Package" (FBM),
  98. that has lots of useful programs for simple image processing,
  99. conversion, etc. The author is Michael Mauldin <mlm@nl.cs.cmu.edu>.
  100. The Utah Raster Toolkit is also a very good graphics package.
  101. Also good is Eric Haines' SPD source code, so you can generate your own
  102. fractal spheres, mountains, gears, etc.
  103.  
  104. Also thanks to the numerous authors whose research into raytracing has
  105. seen implementation in this raytracer.
  106.  
  107. Antonio Costa.
  108.